home *** CD-ROM | disk | FTP | other *** search
/ Merciful 5 / Merciful - Disc 5.iso / software / p / progedv2.4+pseudokeyfile.lha / InstallProgED / HTMLClient_ITA < prev    next >
Encoding:
Text File  |  1997-04-20  |  10.8 KB  |  317 lines
  1.  
  2.                             HTMLClient V1.1
  3.                           -------------------
  4.  
  5.  
  6. Introduzione
  7. -------------
  8.  
  9.     A partire dalla versione 2.3 nel pacchetto di distribuzione di
  10. ProgED è fornito un cliente con interfaccia MUI il cui scopo è di
  11. aiutare l'utente nella scrittura di pagine HTML. Tale cliente offre
  12. la stessa interfaccia di WebPlug poichè, attualmente, è una delle
  13. migliori in circolazione. Ho scritto questo cliente poichè, oramai,
  14. ProgED non è più un editor rivolto esclusivamente ai programmatori
  15. (a dispetto del nome), come era nelle precedenti versioni, ma si è
  16. evoluto fino a diventare un editor molto flessibile adatto ad ogni
  17. esigenza. Attualmente, inoltre, molte persone hanno bisogno di
  18. editor particolari, capaci di aiutarli nella compilazione delle ormai
  19. usatissime pagine HTML (lavoro semplice ma molto noioso). Da tutte
  20. queste considerazioni è nata l'idea di creare un cliente che aiutasse
  21. l'utente a scrivere le sue pagine. Ho scritto tale programma usando
  22. una interfaccia MUI poichè questo mi ha, ovviamente, permesso di 
  23. diminuire i tempi necessari allo sviluppo, ma anche perchè era 
  24. necessaria una interfaccia più funzionale di quella offerta dalla
  25. triton o da gadtools e poichè l'utente che crea pagine HTML è un
  26. utente molto esigente nel campo della GUI. In poco più di cento
  27. Kbytes di codice ho, quindi, inglobato tutte quello che mi sembrava
  28. utile o indispensabile per il creatore di pagine WEB. Il cliente è
  29. stato scritto in modo personalizzabile: consente l'uso di 3 browser
  30. pre-configurati (IBrowse, AWeb e Voyager/Mindwalker), o la
  31. personalizzazione configurandolo con tutto ciò che è necessario
  32. sapere riguardo al browser utilizzato. Il cliente, inoltre, modifica
  33. automaticamente i nomi dei link e delle immagini inserite affinchè
  34. tutto giri bene anche sull'host su cui verranno copiate. E' possibile,
  35. tramite un solo click sul mouse, "spedire" la pagina attualmente editata
  36. al browser (eventualmente caricandolo, se non è già in memoria) e vedere,
  37. quindi, in tempo reale i cambi effettuati. L'utilizzo di un apposito
  38. tipo-file di ProgED consente la colorazione automatica di tutti i tag
  39. dello standard HTML 3.0 consentendo una più facile ricerca degli 
  40. stessi. Una nuova modalità, introdotta appositamente per questo cliente,
  41. consente la traduzione "al volo" di caratteri con codice ascii superiore
  42. a 160 nel relativo tag HTML.
  43.  
  44.  
  45.  
  46. Installazione e configurazione
  47. -------------------------------
  48.  
  49.      L'installazione e la configurazione del cliente è molto semplice. 
  50. Per semplicità mi riferirò alle preferenze standard fornite con la
  51. distribuzione della 2.4. Utilizzando tali preferenze l'installazione
  52. non è necessaria, chi non le usa deve inserire il cliente nella lista
  53. dei clienti gestiti da ProgED ed utilizzare i comandi interni da esso
  54. creati associandoli a bottoni della toolbar, a tasti o a menù appositi.
  55. La configurazione avviene usando il comando interno HTML_PREFS o
  56. l'apposito bottone della toolbar del tipo-file HTML. Una volta aperta
  57. la finestra delle preferenze è sufficiente seguire l'help in linea
  58. fornito dalla MUI per configurare il cliente.
  59.  
  60.  
  61.  
  62. Uso
  63. ----
  64.  
  65.      Innanzitutto le preferenze standard di ProgED definiscono una
  66. toolbar che permette l'inserimento di molti tag HTML nelle tue pagine,
  67. ma il client non fa solo questo...
  68.  
  69.      Apri la finestra delle preferenze (utilizzando il piccolo bottone
  70. col punto interrogativo sulla toolbar o, comunque, usando il comando
  71. interno HTML_PREFS. Clicca sulla pagina "Miscellanee" e attiva il
  72. flag di compilazione. Ora, appena manderai una pagina al tuo browser
  73. o cliccando sul piccolo bottone a forma d'occhio o usando il
  74. comando interno HTML_BROWSE il client COMPILERA' la tua pagina.
  75. Cosa significa ? Il cliente controllera' (quasi) tutti i link
  76. nella tua pagina(e) e, se necessario, aprirà una finestra d'errori
  77. mostrando i link errati. In più è possibile usare il file "HTML.config"
  78. nella directory principale del tuo sito (quella scritta nel gadget
  79. "Base file" della finestra delle preferenze). Qui c'e' un piccolo
  80. esempio:
  81.  
  82. CUT HERE>-----------------------------------------
  83.  
  84. ; Controlla i link alle pagine (<A HREF="xxx">)
  85. CHECKPAGELINKS
  86.  
  87. ; Controlla i link alle immagini (<IMG SRC="xxx">)
  88. CHECKIMAGELINKS
  89.  
  90. ; Controlla i link alle musiche (<EMBED SRC="xxx">)
  91. CHECKMUSICLINKS
  92.  
  93. ; Controlla i link agli sfondi (<BODY BACKGROUND="xxx">)
  94. CHECKBACKGROUNDLINKS
  95.  
  96. ; Cerca file non utilizzati
  97. CHECKNOTREFERENCED
  98.  
  99. ; Che file devo controllare ?
  100. PATTERN #?.(html|htm)
  101.  
  102. ; Nome dei file indice
  103. INDEX index.html
  104.  
  105. ; Definizione nuovo tag
  106. ; HEADER = Nome nuovo tag
  107. ; ARG1 = argomento tag
  108. NEWTAG <HEADER> $(ARG1)
  109. <$(ARG1)>
  110. <IMG SRC="pics/proged.gif" WIDTH="314" HEIGHT="97" ALT="ProgED"><br>
  111. <IMG SRC="pics/homepage.gif" WIDTH="349" HEIGHT="77" ALT="home page"><br>
  112. /NEWTAG
  113.  
  114. ; Definizione variabile
  115. VAR address=3donline@ita.flashnet.it
  116.  
  117. CUT HERE>-----------------------------------------------------------
  118.  
  119. Utilizzando questo esempio potrai inserire:
  120.  
  121. <!--VAR $(address)--><!--/VAR-->
  122.  
  123. nella tua pagina per inserire il tuo indirizzo al momento della
  124. compilazione. Inoltre, se scriverai:
  125.  
  126. <!--HEADER $(center)--><!--/HEADER-->
  127.  
  128. potrai inserire la suddetta (vedi esempio) macro e sostituire $(ARG1)
  129. con CENTER per ottenere "<CENTER>".
  130.  
  131.      Scommetto che ti starai chiedendo: "Come funziona?". La risposta e'
  132. semplice. Dopo una compilazione vedrai nella tua pagina:
  133.  
  134. <!--VAR $(address)-->3donline@ita.flashnet.it<!--/VAR-->
  135.  
  136. <!--HEADER $(center)-->
  137. <center>
  138. <IMG SRC="pics/proged.gif" WIDTH="314" HEIGHT="97" ALT="ProgED"><br>
  139. <IMG SRC="pics/homepage.gif" WIDTH="349" HEIGHT="77" ALT="home page"><br>
  140. NEWTAG <HEADER>
  141. <!--/HEADER-->
  142.  
  143. ProgED, infatti, compilando cancellerà tutto il testo tra i tag di
  144. inizio e fine (<!--VAR--> e <!--/VAR--> per esempio) e scriverà il
  145. nuovo testo.
  146.  
  147. Bene, ora ti starai chiedendo: "Mi serve?". Io penso di si. Queste
  148. utili macro ti aiuteranno a modificare il tuo sito piuttosto
  149. facilmente. Generalmente, ad esempio, io creo pagine con testa e
  150. piede sempre uguali. Creandoli utilizzando una macro ti permetterà
  151. di cambiare il tuo sito cambiando solo il file HTML.config e
  152. ricompilando il tuo sito.
  153.  
  154.  
  155.  
  156. Il file HTML.Config
  157. --------------------
  158.  
  159.       Per scrivere un corretto file di configurazione segui le seguenti
  160. regole:
  161.  
  162. 1) Le righe vuote sono ammesse.
  163. 2) Ogni commento deve iniziare con un ';'
  164. 3) Queste sono le esatte keywords (case insensitive):
  165.  
  166.         a) CHECKPAGELINKS
  167.  
  168.            Abilita il controllo per le pagine (default).
  169.            Usa NOCHECKPAGELINKS per disabilitarlo.
  170.  
  171.         b) CHECKIMAGELINKS
  172.  
  173.            Abilita il controllo per le immagini (default).
  174.            Usa NOCHECKIMAGELINKS per disabilitarlo.
  175.  
  176.         c) CHECKMUSICLINKS
  177.  
  178.            Abilita il controllo per le musiche (default).
  179.            Usa NOCHECKMUSICLINKS per disabilitarlo.
  180.  
  181.         d) CHECKBACKGROUNDLINKS
  182.  
  183.            Abilita il controllo per gli sfondi (default).
  184.            Usa NOCHECKBACKGROUNDLINKS per disabilitarlo.
  185.  
  186.         e) CHECKNOTREFERENCED
  187.  
  188.            Abilita il controllo per i file inutilizzati.
  189.            Usa NOCHECKNOTREFERENCED per disabilitarlo (default).
  190.  
  191.         f) PATTERN <pattern amigados>
  192.  
  193.            Specifica i file da controllare (default: "#?.(html|htm)").
  194.  
  195.         g) INDEX <nome file indici>
  196.  
  197.            Specifica i nomi delle pagine indice (default: "index.html").
  198.  
  199. 4) Creazione nuovo tag
  200.  
  201.         NEWTAG <NAME> $(ARG1) $(ARG2) ... $(ARGn)
  202.         ...
  203.         Testo che usa gli argomenti $(ARG1) $(ARG2) ... $(ARGn)
  204.         ...
  205.         /NEWTAG
  206.  
  207.    Utilizzo nella pagine HTML:
  208.  
  209.    <!--NAME $(questo e' arg1) $(questo e'arg2) ... $(questo e' argn)-->
  210.    <!--/NAME-->
  211.  
  212. 5) Creazione variabili:
  213.  
  214.         VAR NAME=testo della variabile
  215.  
  216.    Utilizzo nella pagine HTML:
  217.  
  218.    <!--VAR $(NAME)-->
  219.    <!--/VAR-->
  220.  
  221. 6) Non puoi nidificare l'uso di variabili e macro (in questa versione).
  222.  
  223.  
  224.       Nota che non usando un file HTML.config i settaggi di default ti
  225. permetteranno comunque di controllare i link errati.
  226.  
  227.  
  228.  
  229. Distribuzione
  230. --------------
  231.  
  232.      HTMLClient è, per ora, fornito come GIFTWARE. Ciò significa che 
  233. può utilizzarlo chiunque (abbia una copia registrata di ProgED). A
  234. suo piacere l'utente può mandarmi un qualunque "regalo" per sdebitarsi.
  235. In ogni caso HTMLCLient rimane Copyright by Giovanni Lambiase ed, in
  236. futuro, mi riservo qualunque decisione su di esso. In particolare,
  237. HTMLClient potrebbe diventare Public Domain (distribuendolo separatamente
  238. da  ProgED, eventualmente comprendendo nella sua distribuzione anche i 
  239. suoi sorgenti) o Shareware richiedendo una quota di registrazione 
  240. distinta da quella di ProgED per il suo uso. Comunque chi mi invierà
  241. qualcosa per il suo uso diverrà automaticamente utente registrato e
  242. riceverà il suo keyfile. Infine, potrei decidere di cessare lo sviluppo
  243. del cliente (diritto che mi riservo anche per ProgED stesso). Anche
  244. se GIFTWARE HTMLClient NON deve essere distribuito separatamente da
  245. ProgED. Tale programma può essere utilizzato SOLO insieme a ProgED ed è,
  246. quindi, necessario ed OBBLIGATORIO distribuirli insieme. Sono, ovviamente,
  247. esentati dal "regalo" chiesto agli utenti di HTMLClient chi non lo usa,
  248. cioè chi usa ProgED ma non il cliente.
  249.  
  250.  
  251.  
  252. Autore
  253. -------
  254.  
  255.     Sebbene credo non sia necessario ecco i miei dati:
  256.  
  257.        Giovanni Lambiase
  258.        Via Capo Di Piazza , 6
  259.        84010 Minori (SA) - Italy
  260.  
  261. Per ulteriori informazioni su di me consulta la documentazione di 
  262. ProgED.
  263.  
  264.  
  265.  
  266. Conclusioni
  267. ------------
  268.  
  269.     Ho scritto questo cliente in 10 giorni quindi non mi aspetto che
  270. tutti siamo contenti di esso; ho solo voluto offrire agli utenti
  271. registrati di ProgED un "bonus". Comunque sono ben accetti bug-reports
  272. e suggerimenti. E', ovviamente, consigliata l'uso della posta
  273. elettronica per l'invio dei suggerimenti e bug-reports. Riguardo lo
  274. sviluppo di HTMLClient esso progredirà parallelamente a quello di ProgED
  275. finchè troverò utile farlo.
  276.  
  277.  
  278.  
  279. ----------------------------------------------------------------------
  280.  
  281.                           This application uses
  282.  
  283.  
  284.                         MUI - MagicUserInterface
  285.  
  286.                 (c) Copyright 1993-96 by Stefan Stuntz
  287.  
  288.  
  289. MUI is a system to generate and maintain graphical user interfaces. With
  290. the  aid  of  a  preferences program, the user of an application has the
  291. ability to customize the outfit according to his personal taste.
  292.  
  293. MUI is distributed as shareware. To obtain a complete package containing
  294. lots of examples and more information about registration please look for
  295. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  296. your local bulletin boards or on public domain disks.
  297.  
  298.           If you want to register directly, feel free to send
  299.  
  300.  
  301.                          DM 30.-  or  US$ 20.-
  302.  
  303.                                   to
  304.  
  305.                              Stefan Stuntz
  306.                         Eduard-Spranger-Straße 7
  307.                              80935 München
  308.                                 GERMANY
  309.  
  310.  
  311.  
  312.              Support and online registration is available at
  313.  
  314.                           http://www.sasg.com/
  315.  
  316.  
  317.